home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XRaiseWindow.z / XRaiseWindow
Encoding:
Text File  |  1998-10-30  |  9.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXRRRRaaaaiiiisssseeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXRRRRaaaaiiiisssseeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XRaiseWindow, XLowerWindow, XCirculateSubwindows,
  10.           XCirculateSubwindowsUp, XCirculateSubwindowsDown,
  11.           XRestackWindows - change window stacking order
  12.  
  13.      SSSSYYYYNNNNTTTTAAAAXXXX
  14.           XRaiseWindow(_d_i_s_p_l_a_y, _w)
  15.                 Display *_d_i_s_p_l_a_y;
  16.                 Window _w;
  17.  
  18.           XLowerWindow(_d_i_s_p_l_a_y, _w)
  19.                 Display *_d_i_s_p_l_a_y;
  20.                 Window _w;
  21.  
  22.           XCirculateSubwindows(_d_i_s_p_l_a_y, _w, _d_i_r_e_c_t_i_o_n)
  23.                 Display *_d_i_s_p_l_a_y;
  24.                 Window _w;
  25.                 int _d_i_r_e_c_t_i_o_n;
  26.  
  27.           XCirculateSubwindowsUp(_d_i_s_p_l_a_y, _w)
  28.                 Display *_d_i_s_p_l_a_y;
  29.                 Window _w;
  30.  
  31.           XCirculateSubwindowsDown(_d_i_s_p_l_a_y, _w)
  32.                 Display *_d_i_s_p_l_a_y;
  33.                 Window _w;
  34.  
  35.           XRestackWindows(_d_i_s_p_l_a_y, _w_i_n_d_o_w_s, _n_w_i_n_d_o_w_s);
  36.                 Display *_d_i_s_p_l_a_y;
  37.                 Window _w_i_n_d_o_w_s[];
  38.                 int _n_w_i_n_d_o_w_s;
  39.  
  40.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  41.           _d_i_r_e_c_t_i_o_n Specifies the direction (up or down) that you want
  42.                     to circulate the window. You can pass _R_a_i_s_e_L_o_w_e_s_t
  43.                     or _L_o_w_e_r_H_i_g_h_e_s_t.
  44.  
  45.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  46.  
  47.           _n_w_i_n_d_o_w_s  Specifies the number of windows to be restacked.
  48.  
  49.           _w         Specifies the window.
  50.  
  51.           _w_i_n_d_o_w_s   Specifies an array containing the windows to be
  52.                     restacked.
  53.  
  54.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  55.           The _X_R_a_i_s_e_W_i_n_d_o_w function raises the specified window to the
  56.           top of the stack so that no sibling window obscures it.  If
  57.           the windows are regarded as overlapping sheets of paper
  58.           stacked on a desk, then raising a window is analogous to
  59.           moving the sheet to the top of the stack but leaving its x
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXRRRRaaaaiiiisssseeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXRRRRaaaaiiiisssseeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           and y location on the desk constant.  Raising a mapped
  75.           window may generate _E_x_p_o_s_e events for the window and any
  76.           mapped subwindows that were formerly obscured.
  77.  
  78.           If the override-redirect attribute of the window is _F_a_l_s_e
  79.           and some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k
  80.           on the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t
  81.           event, and no processing is performed.  Otherwise, the
  82.           window is raised.
  83.  
  84.           _X_R_a_i_s_e_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.
  85.  
  86.           The _X_L_o_w_e_r_W_i_n_d_o_w function lowers the specified window to the
  87.           bottom of the stack so that it does not obscure any sibling
  88.           windows.  If the windows are regarded as overlapping sheets
  89.           of paper stacked on a desk, then lowering a window is
  90.           analogous to moving the sheet to the bottom of the stack but
  91.           leaving its x and y location on the desk constant.  Lowering
  92.           a mapped window will generate _E_x_p_o_s_e events on any windows
  93.           it formerly obscured.
  94.  
  95.           If the override-redirect attribute of the window is _F_a_l_s_e
  96.           and some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k
  97.           on the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t
  98.           event, and no processing is performed. Otherwise, the window
  99.           is lowered to the bottom of the stack.
  100.  
  101.           _X_L_o_w_e_r_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.
  102.  
  103.           The _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s function circulates children of the
  104.           specified window in the specified direction.  If you specify
  105.           _R_a_i_s_e_L_o_w_e_s_t, _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s raises the lowest mapped
  106.           child (if any) that is occluded by another child to the top
  107.           of the stack.  If you specify _L_o_w_e_r_H_i_g_h_e_s_t,
  108.           _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s lowers the highest mapped child (if
  109.           any) that occludes another child to the bottom of the stack.
  110.           Exposure processing is then performed on formerly obscured
  111.           windows.  If some other client has selected
  112.           _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on the window, the X server
  113.           generates a _C_i_r_c_u_l_a_t_e_R_e_q_u_e_s_t event, and no further
  114.           processing is performed.  If a child is actually restacked,
  115.           the X server generates a _C_i_r_c_u_l_a_t_e_N_o_t_i_f_y event.
  116.  
  117.           _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w
  118.           errors.
  119.  
  120.           The _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_U_p function raises the lowest mapped
  121.           child of the specified window that is partially or
  122.           completely occluded by another child.  Completely unobscured
  123.           children are not affected.  This is a convenience function
  124.           equivalent to _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s with _R_a_i_s_e_L_o_w_e_s_t
  125.           specified.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXRRRRaaaaiiiisssseeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXRRRRaaaaiiiisssseeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_U_p can generate a _B_a_d_W_i_n_d_o_w error.
  141.  
  142.           The _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_D_o_w_n function lowers the highest
  143.           mapped child of the specified window that partially or
  144.           completely occludes another child.  Completely unobscured
  145.           children are not affected.  This is a convenience function
  146.           equivalent to _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s with _L_o_w_e_r_H_i_g_h_e_s_t
  147.           specified.
  148.  
  149.           _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_D_o_w_n can generate a _B_a_d_W_i_n_d_o_w error.
  150.  
  151.           The _X_R_e_s_t_a_c_k_W_i_n_d_o_w_s function restacks the windows in the
  152.           order specified, from top to bottom.  The stacking order of
  153.           the first window in the windows array is unaffected, but the
  154.           other windows in the array are stacked underneath the first
  155.           window, in the order of the array.  The stacking order of
  156.           the other windows is not affected.  For each window in the
  157.           window array that is not a child of the specified window, a
  158.           _B_a_d_M_a_t_c_h error results.
  159.  
  160.           If the override-redirect attribute of a window is _F_a_l_s_e and
  161.           some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on
  162.           the parent, the X server generates _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t events
  163.           for each window whose override-redirect flag is not set, and
  164.           no further processing is performed.  Otherwise, the windows
  165.           will be restacked in top-to-bottom order.
  166.  
  167.           _X_R_e_s_t_a_c_k_W_i_n_d_o_w_s can generate _B_a_d_W_i_n_d_o_w error.
  168.  
  169.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  170.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  171.                     values accepted by the request.  Unless a specific
  172.                     range is specified for an argument, the full range
  173.                     defined by the argument's type is accepted.  Any
  174.                     argument defined as a set of alternatives can
  175.                     generate this error.
  176.  
  177.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  178.                     defined Window.
  179.  
  180.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  181.           XChangeWindowAttributes(3X11), XConfigureWindow(3X11),
  182.           XCreateWindow(3X11), XDestroyWindow(3X11), XMapWindow(3X11),
  183.           XUnmapWindow(3X11)
  184.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.